Reports whether a mouse click should activate the window path pop-up menu.

Boolean IsWindowPathSelectClick (
    WindowRef window, 
    const EventRecord *event
);

window

A pointer to the window in which the mouse-down event occurred.

event

A pointer to the EventRecord structure containing the mouse-down event that IsWindowPathSelectClick is to examine.

function result

true if the mouse click should activate the window path pop-up menu; otherwise false.

DISCUSSION

The Mac OS 8.5 Window Manager provides system support for your application to display window path pop-up menus—like those used in Finder windows. When the user presses the Command key and clicks on the window’s title, the window displays a pop-up menu containing a standard file system path, informing the user of the location of the document displayed in the window and allowing the user to open windows for folders along the path.

Because the window title includes both the proxy icon region and part of the drag region of the window, your application must be prepared to respond to a click in either region by displaying a window path pop-up menu. Therefore, when the FindWindow function returns either the inDrag or the inProxyIcon result code—you should pass the event to the IsWindowPathSelectClick function to determine whether the mouse-down event should activate the window path pop-up menu. If IsWindowPathSelectClick returns a value of true, your application should then call the function WindowPathSelect to display the menu.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when WindowsLib 8.5 or later is installed. Exported by CarbonLib 1.0 and later and by WindowsLib 8.5 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)